package com.yami.shop.service;

import org.springframework.http.ResponseEntity;

import java.util.Map;

/**
 * 微信小程序服务接口
 */
public interface WxMaService {
    
    /**
     * 获取小程序码（适用于需要的码数量较少的业务场景）
     * 
     * @param page 跳转页面路径
     * @param scene 场景参数
     * @param width 二维码宽度
     * @param autoColor 自动配置线条颜色
     * @param lineColor 线条颜色
     * @param isHyaline 是否需要透明底色
     * @return 小程序码图片的Base64编码
     */
    ResponseEntity<Map<String, Object>> getWxacode(String page, String scene, Integer width, 
                                                 Boolean autoColor, String lineColor, Boolean isHyaline);
    
    /**
     * 获取小程序码（适用于需要的码数量极多的业务场景）
     * 
     * @param page 跳转页面路径
     * @param scene 场景参数
     * @param width 二维码宽度
     * @param autoColor 自动配置线条颜色
     * @param lineColor 线条颜色
     * @param isHyaline 是否需要透明底色
     * @return 小程序码图片的Base64编码
     */
    ResponseEntity<Map<String, Object>> getWxacodeUnlimit(String page, String scene, Integer width, 
                                                        Boolean autoColor, String lineColor, Boolean isHyaline);
    
    /**
     * 获取小程序二维码（适用于需要的码数量较少的业务场景）
     * 
     * @param path 跳转页面路径
     * @param width 二维码宽度
     * @return 小程序二维码图片的Base64编码
     */
    ResponseEntity<Map<String, Object>> createWxaQrcode(String path, Integer width);
} 